Начало работы

Чтобы начать работать с Яндекс Такси:

1. Получите токен для отправки запросов к API:

   1. Войдите в Кабинет Корпоративного Клиента Яндекс Такси с помощью почты, к которой привязан аккаунт в Яндекс Go для бизнеса.

   2. Перейдите на вкладку Профиль компании.

   3. Нажмите кнопку Получить токен.

   4. На странице oauth.yandex.ru нажмите кнопку Войти как <ваш логин>. Вы будете перенаправлены в Кабинет Корпоративного Клиента Яндекс Такси.

   5. В блоке Токен сгенерирован будет отображен ваш OAuth-токен.

2. Токены для доступа к API действуют ограниченное время, после которого становятся недействительными. Используйте запрос Обновить OAuth-токен, чтобы получить время жизни вашего токена.

   • Если время жизни токена подходит к концу — повторно выполните запрос Обновить OAuth-токен. Дата устаревания вашего токена будет обновлена, и вы сможете пользоваться текущим токеном дальше.

   • Если время жизни токена истекло — получите новый токен в Кабинете Корпоративного Клиента Яндекс Такси.

   Примечание

   Если токен утерян, для перевыпуска обратитесь в Яндекс Паспорт.

3. Используйте OAuth-токен во всех запросах к API. Передавайте токен в заголовке:

   • в версии API 1.0: Authorization: <значение вашего токена>;

   • в версии API 2.0: Authorization: Bearer <значение вашего токена>.

   Примечание

   Для работы с API 1.0 используйте хост https://business.taxi.yandex.ru, а для работы с API 2.0 — хост http://b2b-api.go.yandex.ru.

4. Если один аккаунт в Яндекс ID имеет доступ к нескольким личным кабинетам, для всех запросов нужно указывать заголовок X-YaTaxi-Selected-Corp-Client-Id следующим образом:

   1. В личном кабинете перейдите на вкладку Профиль компании.

   2. Передайте в заголовок ID клиента.

5. Укажите информацию о кост-центрах.

6. Создайте роли пользователей.

7. Заведите учетные записи пользователей:

   • в версии API 1.0: создание пользователя;

   • в версии API 2.0: создание пользователя.

Заказ поездки

После того, как вы получили токен и указали информацию о ваших пользователях, вы можете использовать API Яндекс Такси для заказа поездок.

Процедура заказа выглядит следующим образом:

1. Узнайте цену и условия предстоящей поездки и получите оффер.

2. Создайте черновик заказа.

3. Передайте заказ на обработку.

4. При необходимости отмените заказ.